SetWindowProxyFSSpec

Associates a file with a window.

pascal OSStatus SetWindowProxyFSSpec (
WindowPtr window,
const FSSpec *inFile);

window

A value of type WindowPtr . Pass a pointer to the window with which the specified file is to be associated.

inFile

A pointer to an FSSpec structure. Before calling SetWindowProxyFSSpec , set the file system specification structure to contain the data for the file to associate with the specified window. You can obtain an FSSpec structure by calling the function GetWindowProxyFSSpec . See Inside Macintosh: Files for more information on the FSSpec data type.

function result

A result code. See Result Codes.

DISCUSSION

Your application should call the SetWindowProxyFSSpec function to establish a proxy icon for a given window. The creator code and file type of the file associated with a window determine the proxy icon that is displayed for the window.

Because the SetWindowProxyFSSpec function won't work without a saved file, you must establish the initial proxy icon for a new, untitled window with the function SetWindowProxyCreatorAndType , which requires that you know the file type and creator code for the file, but does not require that the file have been saved.

See Supporting Window Proxy Icons for examples of how your application can provide proxy icon support in its document windows.

SPECIAL CONSIDERATIONS

With Mac OS 8.5, you must save and restore the current graphics port--by calling the QuickDraw functions GetPort and SetPort --around each call to the SetWindowProxyFSSpec function.

VERSION NOTES

Available with Mac OS 8.5 and later.